UNLOAD

Syntax: UNLOAD program_name
Location: MutiBASIC (DIY Toolkit - Vol M)

This toolkit provides a quick means of saving and loading programs in memory.

This command allows you to store the currently loaded SuperBASIC program in memory.  You have to supply a name for the program (similar to the name which you could use with the SAVE command, except there is no need for a device name and the program name can be up to 127 characters long).  The program is then stored - details of the programs which have been stored with this command are available from the jobs list (see JOBS).

When the program is stored in memory, the contents of all variables and pointers are also stored, which makes certain that if you UNLOAD a program whilst it is RUNning, you can later RELOAD it and re-start it from the same place (with CONTINUE).

v4.0+ of the toolkit, allows you to store the current screen display and mode along with the program, so that when the program is RELOADed, the display is in a known layout.

To further extend the usefulness of this toolkit, any commands which appear after UNLOAD will be automatically executed when the program is RELOADed, for example:

UNLOAD test : RUN

will always RUN the program when you:

RELOAD test

CROSS-REFERENCE:
SCR_SAVE allows you to dictate whether the screen display and mode should be stored together with the program.
RESAVE is similar.
REMOVE allows you to remove a program stored in memory with this command.
See also RELOAD and QSAVE.
